home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / hdir12.arc / HDIR.DOC < prev   
Encoding:
Text File  |  1987-01-28  |  9.9 KB  |  220 lines
  1.  
  2. HotDIR 1.2 Documentation   -   (c) 1987 by Robert Woeger     1-28-1987
  3. ___________________________________________________________________________
  4.  
  5.  
  6. HotDIR (hot directory) is a user supported software utility I have developed
  7. to help PC users get the most out of their PC monitors.  Unlike most directory
  8. utilities to date, HotDIR uses color extensively to SHOW you your files.
  9. You do NOT need to have a color monitor to use HotDIR (colors will show as
  10. intensities on a monochrome screen), but boy, HotDIR sure makes your directory
  11. HOT on a color system (CGA) or an EGA. 
  12.  
  13. HotDIR sorts your files in columns (up and down) and displays different colors
  14. for different types of files (based on their extension).  It supports
  15. pathnames and wildcards also.  At the end of the directory listing, you will
  16. also see the total space on the specified drive, and the space available.
  17.  
  18. The idea for HotDIR (and the name) came from a good friend of mine, John P.
  19. German.  He wanted to make full use of his color monitor, but faced a problem
  20. that the DIR command and his other directory utilities didn't use colors for
  21. displaying text. He asked me to see what I could do for him, and I
  22. subsequently locked myself in my room until I emerged many hours later with
  23. a rough version of what is now HotDIR.  Without his encouragement and
  24. criticisms, I would have never written HotDIR.  Thanks, John.
  25.  
  26. I suggest that you simply run HotDIR, and play around with it.  If you prefer
  27. to read about it, you can continue.  If you are like me, I want to run new
  28. programs without reading the documentation first.  You can't hurt anything by
  29. running HDIR, so give it a try now.
  30.  
  31.  
  32. HotDIR consists of 2 files:
  33.  
  34.     HDIR.COM    The executable program (100% assembly code for speed
  35.             and size).
  36.     HDIR.DOC    This documentation file.
  37.  
  38.  
  39.  
  40. The format for running HDIR.COM is the following:
  41.  
  42.     HDIR [d:\pathname\filename or wildcard]
  43.  
  44.  
  45. where [...] is an optional.  If you do not specify the pathname/filename(s),
  46. HotDIR will use the current directory on the default drive and search for
  47. all files (including hidden, system, and subdirectory files).
  48.  
  49. Examples:
  50.  
  51.     HDIR *.*    Both of these perform the same function
  52.     HDIR        (display all files in the current directory)
  53.  
  54.     HDIR \util\*.*         Displays all files in the subdirectory \util
  55.  
  56.     HDIR \robert\terminal\*.COM    Displays all .COM files in specified dir
  57.  
  58.  
  59.  
  60. The colors displayed for the different file types were chosen after careful
  61. consideration.    We did run out of displayable colors (i.e. those that were
  62. readable enough for text) so we grouped 2 similar categories into the same
  63. color.    Otherwise, each of the file types has its own unique color:
  64.  
  65.     .BAS    -    Green (low intensity)
  66.     .PAS    -    Green (low intensity)
  67.     .DOC    -    Hi White
  68.     .TXT    -    Hi White
  69.  
  70.     .COM    -    Hi green
  71.     .EXE    -    Hi sky blue
  72.     .BAT    -    Hi red
  73.     .ARC    -    Brown
  74.  
  75.     Hidden files    Dark red
  76.     Subdirectories    Magenta (hi purple)
  77.     All other files Gray
  78.  
  79.     All numbers    Yellow
  80.  
  81. Colors really liven up directories, and I'll probably never go back to one
  82. color text directory utilities again.  HotDIR makes it easy to spot a
  83. particular type of file (.BAT for instance) without having to re-sort by
  84. extension, etc.
  85.  
  86.  
  87.  
  88. Technical notes:
  89. ----------------
  90.  
  91.  
  92.  1.  Files larger than ~ 1 megabyte each will have the message "1 Meg+"
  93. in place of the file size.  This is because I have a limited space when
  94. displaying 4 columns of files.    Most people will probably never see this
  95. message because few files today are bigger than 1,000,000 bytes long.
  96.  
  97.  2.  If you get a message saying that the sort area is full, you will
  98. have to remove some files from the directory or free up some memory space.
  99. HotDIR 1.2's limit is approx. 5,000 files.  Again, for most people this
  100. should not be a problem.
  101.  
  102.  3.  HotDIR uses BIOS Video calls to perform most of its display of text.
  103. This is due to the problem people would have using ANSI.SYS to change colors
  104. while running HotDIR.  HotDIR bypasses DOS (and ANSI.SYS) so ANSI.SYS can't
  105. change HotDIRs directory colors.  One restriction on HotDIR is that its output
  106. can't be redirected to a file or other device.  This is because redirection
  107. occurs at the DOS level, not at the BIOS level.
  108.  
  109.  4.  HotDIR works on all 100% IBM PC compatible computers tested.  It was
  110. tested using both the monochrome, color graphics (CGA), and EGA display
  111. adapters.
  112.  
  113.  5.  MS/PC-DOS Versions 2.1 through 3.2 were tested with HotDIR.
  114.  
  115.  6.  I recommend that you use a good disk cache program when running HotDIR on
  116. a PC with a hard disk.  A cache helps speed up HDIR's disk reading by ~400%.
  117.  
  118.  7.  If the directory that you want HDIR to display has a lot of files on it
  119. and/or the disk is fragmented, HDIR will run slower than normal.  Either use a
  120. disk cache, de-fragment your hard disk, or move some files out of that
  121. directory (the fewer files HotDIR has to sort, the faster it will be).
  122.  
  123.  
  124. _______________________________________________________________________
  125.  
  126.  
  127. Release 1.2 Notes:
  128. -----------------
  129.  
  130.  
  131. Robert Woeger is the author of this and other PC utilities such as PCSTAT.
  132. He wrote the original HotDIR program (Version 1.1) and enlisted the help
  133. of Tony Overfield for help with release 1.2 of HotDIR.  Tony did a fantastic
  134. job and helped HotDIR to shrink from over 6K in disk space to approximately
  135. half that (3K).  This is due to the removal of the fixed filename sort buffer
  136. that was used in HotDIR 1.1.  Listed below are the improvements between
  137. HotDIR 1.1 and 1.2:
  138.  
  139.         1.  Eliminated the fixed sort area (245 file maximum per directory).
  140.             Now HotDIR will handle up to approximately 5,000 files per
  141.             directory!
  142.  
  143.         2.  Added new code to eliminate some background/foreground color
  144.             conflicts HotDIR had with other color changing utilities.
  145.  
  146.         3.  Eliminated INT 3 instructions embedded in HotDIR 1.1 code.  These
  147.             instructions are used with various debugging tools to set
  148.             breakpoints within HotDIR.  After testing, these codes should have
  149.             been removed, but were not.  This caused no problems on most
  150.             machines, but did cause TSR utilities to do strange things
  151.             occasionally.  These 'CC' codes have been removed from HotDIR 1.2.
  152.  
  153.         4.  HotDIR 1.2 will now tell you when no files match your wildcard or
  154.             filename specification(s).  HotDIR 1.1 told you that you had
  155.             specified an invalid filename, drive, or path whenever it found no
  156.             matching filename(s).
  157.  
  158.  
  159. ******************************************************************************
  160. Rob and Tony are currently designing what will be HotDIR 2.0.  HotDIR 2.0
  161. should be completed no later than mid-February 1987.  HotDIR 2.0 will be a
  162. major re-write of HotDIR 1.2 and will include the following:
  163.  
  164.         1.  Re-worked sorting algorithm for MUCH faster sorting of files.
  165.         2.  Removal of the need to re-read file names to display them (thus
  166.             reducing Disk Input/Output time considerably!)
  167.         3.  Display of files in 1 column, 2 column, 4 column (the current
  168.             default), or 6 column display formats.  You can select the format
  169.             you prefer at any time.  HotDIR will display file names, dates,
  170.             times, sizes, and attributes.
  171.         4.  User defined extension colors.  You can specify additional 
  172.             extensions of files you want colored (i.e. .PCL, .COB, .ASM,
  173.             .DAT, .BBS, etc.) and their respective colors.
  174.         5.  More file information (how many files did HDIR display, their
  175.             total size, the size they will take up when transferred to other
  176.             storage mediums [5 1/4" disk, 10Mb Hdisk, etc.], volume label,
  177.             etc.)
  178.         6.  Clear screen before displaying directory option.
  179.         7.  Re-direction of HDIR output to a disk file or printer.
  180.         8.  No need to specify *.* after a subdirectory's name on command
  181.             line:  HDIR \util   will work in 2.0, where you must type
  182.                    HDIR \util\*.*   in HotDIR 1.2 to get the same result.
  183.  
  184. All of the above feature are tenative and may not be implemented, but we will
  185. do our best to bring you a User Supported product that pleases just about
  186. everyone.  By the way, the above new feature for 2.0 came from your input and
  187. suggestions.  There are no warranties expressed or imlied about HotDIR.  It
  188. has been tested by us, but in no way shall we be liable for any damages
  189. arising out the use of HotDIR.
  190.  
  191.  
  192. HotDIR is Copyrighted 1987 by Robert Woeger and Tony Overfield.  All rights
  193. are reserved.  You may use HotDIR 1.2 free of charge, and may re-distribute
  194. HotDIR 1.2 to others as long as you don't modify HotDIR or charge a fee other
  195. than a disk duplication fee for HotDIR.  Since HotDIR is User Supported, we
  196. ask that you register your copy by sending a $15 donation to us.  All those
  197. who register will receive a disk free of charge with HotDIR 2.0 on it.
  198. HotDIR 2.0 will NOT be distributed to anyone other than those who registered
  199. HotDIR 1.2.  This means that HotDIR 1.2 will be readily available through
  200. Bulletin Boards, User libraries, Information services, etc., but Version 2.0
  201. of HotDIR will not.  By doing it this way, we make sure that users will send
  202. us money to compensate for our work on HotDIR.  I tried the other approach
  203. (kept putting latest versions of PCSTAT out to the public), but only received
  204. 2 (yes, two) people who were kind enough to register.  That was out of the
  205. 2000+ people who downloaded PCSTAT!  Tony and I feel that HotDIR is a superior
  206. product and we will continue to improve it.  We hope you feel the same and
  207. decide to register your copy of HotDIR.
  208.  
  209.  
  210. To register and receive HotDIR 2.0, send a check or money order for $15 to:
  211.  
  212.  
  213.                       Robert Woeger
  214.                       P.O. Box FF
  215.                       College Station, TX 77841
  216.  
  217. Thank you for your support!
  218. Rob Woeger & Tony Overfield.
  219. _______________________________________________________________________________
  220.